4.1.2

Update release script

With gi-docgen based docs, we can try to go back to
including the docs in the main release tarball.

Merge branch 'menubar-accel' into 'master'

window: Add a way to disable F10 shortcut

Closes #3727

See merge request GNOME/gtk!3296

window: Add a way to disable F10 shortcut

This is needed for terminal emulators.

Fixes: #3727

Merge branch 'ngl-less-shaders' into 'master'

Assorted ngl improvements

See merge request GNOME/gtk!3295

ngl: Special-case css backgrounds

Recognize a common pattern: A rounded clip with
a color node, followed by a border node, with the
same outline. This is what CSS backgrounds frequently
produce, and we can render it more efficiently with
a combined shader.

ngl: Don't bother with uniform border nodes

Now that colors aren't uniforms anymore, we don't
win much by using the inset_shadow shader. The fragment
shaders of inset_shadow and border are identical. And
the regular border setup does nine-slicing.

ngl: Small shader improvements

Add a variant of gskSetOutputColor that saves a
few multiplications, and use it where possible.

ngl: Improve the coloring shader

Since we are now passing a float anyway, we can avoid
the branch in the fragment shader.

ngl: Improve the gradient shaders

Use a define for MAX_COLOR_STOPS, and give the loop
a fixed limit.

ngl: Rewrite gsk_ngl_render_job_visit_text_node

Make this more compact, and thus easier to read.

ngl: Drop gsk_ngl_render_job_set_color

Colors are not state that we carry across draw ops,
so setting the color on the render job doesn't make
much sense. Instead, pass the color to the various
draw calls. Add a few new ones for that purpose.

Also, shorten the names of some by going from
'load_vertices_from_offscreen' to 'draw_offscreen'.

ngl: Refactor gsk_ngl_render_job_visit_border_node

With color sorting out of the picture, this can
be much simpler.

ngl: Consistently use gsk_scaled_premultiply

Its not going to make much of a difference, but we
can just as well be consistent.

ngl: Fix up uniform enums

This got messed up when color was changed from
a uniform to an attribute in 06d5c8e72dee3d6339.

Update Finnish translation

(cherry picked from commit f5a34b53afed6f75a257c21dc52b07592ea76681)

Update French translation

(cherry picked from commit 21039681d6df9824599d186934aaa53fd4ba722f)

Update Polish translation

Updated Czech translation

Merge branch 'gles-coloring' into 'master'

ngl: Fix the coloring shader on GLES 2.0

See merge request GNOME/gtk!3294

ngl: Fix the coloring shader on GLES 2.0

Integer varyings didn’t exist in GLSL ES 1.00, neither did the flat
attribute.

Update Norwegian Bokmål translation

(cherry picked from commit 70ee21db71e5b8de0aff406d3d9f1decddebfa09)

Merge branch 'ebassi/for-master' into 'master'

docs: Fix the dependencies links

See merge request GNOME/gtk!3284

Merge branch 'ngl-textview-cursor' into 'master'

Ngl textview cursor

See merge request GNOME/gtk!3292

textview: Fix blinking block cursors

When we have a block cursor, we need to discard the
cached node of the line containing the cursor, in order
to get a blinking cursor.

textview: Fix blinking block cursors

When we have a block cursor, we need to discard the
cached node of the line containing the cursor, in order
to get a blinking cursor.

textlayout: Render cursors at the end

Don't place the insertion cursor render nodes in the
middle of the text nodes for all the text. This helps
the renderer batching the text draw calls together.

ngl: Fix up some debug printouts

Merge branch 'wip/chergert/fewer-uniforms' into 'master'

ngl: apply fewer uniforms

See merge request GNOME/gtk!3289

Merge branch 'pgriffis/readme-fixes' into 'master'

readme: Fix broken doc links

See merge request GNOME/gtk!3291

readme: Fix broken doc links

Merge branch 'ngl-vertex-attributes' into 'master'

Ngl vertex attributes

See merge request GNOME/gtk!3290

ngl: Identify shaders

Add a comment with a name to each shader. That makes
identifying the shaders in apitrace much easier.

ngl: reintroduce comparison checks

This reduces how many changes we make when recording uniform state, which
increases the chances that the data offset will be the same when applying
uniforms.

ngl: add front cache to reduce uniform changes

Since we make full snapshots when recording uniform state of batches, we
need to perform some deduplication to avoid so many repeated uniform calls.

This uses a closed hashtable to determine if we are likely changing the
value to something new.

This does not currently compare values, it instead only compares that we
are going to point at a new offset into the uniform buffer. We could go
further if we compare upon updating values (we did that early on in the
prototype) so that offsets are less likely to be changed.

gtk-demo: Add a test for scrolling with Emoji

Make a text with lots of Emoji and text. This
is exercising the GL renderers switching between
different shaders for color and plain glyphs.

ngl: Make the coloring shader more versatile

When the color passed is transparent black, use
the color from the texture as source, instead of
as mask. This lets use use the coloring program
both for regular and color glyphs, avoiding
program changes in text with Emoji.

ngl: Set color as vertex attribute

Instead of using uniforms for color used in multiple
programs, pass it as vertex attributes. This will let
us batch more draw calls, since we don't have to change
uniforms so often. In particular, for syntax-highlighted
text.

gsk: Give ngl its own shader sources

We may want to change the interface between the
shaders and the renderer for ngl, and therefore,
sharing the shaders between gl and ngl will not
be practical, going forward.

Merge branch 'fix-3704' into 'master'

gdksurface-win32.c: Fix window menu positioning (issue #3704)

Closes #3704

See merge request GNOME/gtk!3286

build: Install the API references

We are building them, but not installing them.

docs: Fix the dependencies links

Use the GitLab pages location until we can link to a proper space on
developer.gnome.org.

gdksurface-win32.c: Fix window menu positioning

We ought to get the coordinates of where the window menu should be
displayed using gdk_win32_surface_get_root_coords(), instead of rounding
the position that we obtained with gdk_event_get_position().

Also rename items a bit in the same function, and call
gdk_event_get_event_type() for consistency with the other backends.

Fixes issue #3704.

Update Korean translation

(cherry picked from commit 7774d5d85e86f97d9ef7195c808bcd2d88ef49eb)

Merge branch 'bilelmoussaoui/shortcuts-annotation' into 'master'

g-i: fix gtk_shortcut_label_new annotation

See merge request GNOME/gtk!3285

g-i: fix gtk_shortcut_label_new annotation

Merge branch 'ebassi/gidocgen' into 'master'

Move API reference to gi-docgen

See merge request GNOME/gtk!3222

docs: Add URL maps for cross links

docs: Enable search

docs: Update the "running GTK apps" section

Style the content a bit better, and use the appropriate links.

Small updates to the coding and documentation style

Mention summary sentences, and a few other things.

build: Add missing variable definition

build: Add a GIR dependency to PangoCairo

This is not strictly needed from an introspection perspective, but:

 - GTK strictly depends on PangoCairo internally
 - we want to integrate the GDK docs with PangoCairo's

So even though we don't have an explicit dependency on PangoCairo types
in our ABI, we do assume that people will be able to use the PangoCairo
API with GTK.

Handle static inline GtkOrdering function

The introspection scanner does not handle `static inline` functions:
they are not in the shared library, so cannot be dlsym() out of it; and
the `static` keyword tells g-ir-scanner to skip the function declaration
entirely.

We can trick the scanner into thinking the gtk_ordering_from_cmpfunc()
symbol is a real, public one, by declaring and defining a regular
function under the `__GI_SCANNER__` guard; the symbol does not appear
when actually building GTK, or any code using GTK, so we don't risk
collisions.

docs: Show class hierarchy in the API references

label: Fix some external links

I had put in a bunch of [class@Pango.Attribute],
but it needs to be [struct@Pango.Attribute].

Know your dependencies` type hierarchy!

text: Fix some copy-paste mishap

A bunch of occurrances of "the self" looked like
absurdist short fiction:

"...the self scrolled off the screen to the left"

widget: Fix up some links

Fix up some links to vfuncs and to sections, as well as class methods.

shortcuttrigger: Convert docs

shortcutlabel: Convert docs

shortcutcontroller: Convert docs

shortcutaction: Convert docs

shortcut: Convert docs

sizegroup: Convert docs

testutils: Convert docs

snapshot: Convert docs

tooltip: Convert docs

settings: Convert docs

recentmanager: Convert docs

mountoperation: Convert docs

menutrackeritem: Remove SECTION

This is private

menutracker: Remove SECTION

This is private.

treesortable: Add a summary

treeselection: Add a summary

treemodelsort: Add a summary

treemodelfilter: Add a summary

treemodel: Add a summary

treednd: Add summaries

treestore: Add a summary

liststore: Add a summary

treeviewcolumn: Add a summary

treeview: Add a summary

windowgroup: Convert docs

listbox: Convert docs

iconview: Add a summary

constraintsolver: Remove SECTION

This is private

cellview: Add a summary

cellrenderertoggle: Add a summary

cellrenderertext: Add a summary

cellrendererspinner: Add a summary

cellrendererspin: Add a summary

cellrendererprogress: Add a summary

cellrendererpixbuf: Add a summary

celleditable: Add a summary

cellrenderercombo: Add a summary

cellrendereraccel: Add a summary

cellrenderer: Add a summary

celllayout: Add a summary

cellareacontext: Add a summary

cellareabox: Add a summary